home *** CD-ROM | disk | FTP | other *** search
/ SPACE 2 / SPACE - Library 2 - Volume 1.iso / games / 2a / music / sound.doc < prev    next >
Text File  |  1985-05-29  |  2KB  |  46 lines
  1.                   Sound.Doc
  2.  
  3.     This is the documentation for the program Sound.prg which inter-
  4.     faces to the sound chip of the ST.The interface is such that you
  5.     can address each channel separately by  clicking the  mouse over  
  6.     the designated area.  The interface  is color  coded as follows: 
  7.     Red indicates that part is off and Green indicates that part is 
  8.     on.
  9.                         
  10.     When you first open sound.prg you will  see InSoft at  the top in 
  11.     green.  By clicking in that  area you will be  getting out of the 
  12.     program. The three areas named CHANNEL A, CHANNEL B and CHANNEL C
  13.     are for the three channels of the ST. Freq. is for the frequency,
  14.     ADSR is for the waveform  and Vol is for the volume for that per-
  15.     spective channel.  The  areas below that give the  magnitudes for 
  16.     that function.  For frequency  there is a  range of numbers.  The 
  17.     ADRS has 10 waveforms along with a period shown on the right side
  18.         of the  column which will also have a range.  The volume has six-
  19.     teen levels. 
  20.  
  21.     By clicking the mouse you can change particular levels of a chan-
  22.     nel or turn the channel off completely.  The Freq., ADSR and Vol.
  23.     for each channel are a function  of each other.  When the ADSR is
  24.     on the frequency and volume are off and the same goes for when the
  25.     frequency and volume are on. Clicking on one will effect the other
  26.     two.
  27.  
  28.     The initial state for this program  is CHANNEL A, B and C are off.
  29.     When the  channels are  clicked on  then the functions  below will 
  30.     take over.  The area will  fill  with  green  at  this  time.  See 
  31.     AY38910.doc for  a quick reference guide for the ST sound chip and
  32.     stsound1.c for a simple sound program.
  33.  
  34.     Sound.c and  sound1.c are the  c source  for  sound.prg. The c pro-
  35.     grams were  compiled separately  and then linked with sound.c call-
  36.     ing the  function  "test" in sound1.c.  All declarations are before
  37.     main() in sound.c and test() in sound.c which means they are exter-
  38.     nal and values will hold across the function call.
  39.  
  40.     Program specs
  41.         -Frequency range is 80hz to 10Khz
  42.         -ADSR envelope range is 0.1 to 8 seconds
  43.          The envelope is small column in ADSR
  44.  
  45.